home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / GRAPHICS / @FALCON / VIEWERS / MPLAYER.230 / MPLYR_GE.DOC < prev    next >
Encoding:
Text File  |  1996-12-30  |  17.0 KB  |  396 lines

  1. ***************************************************************
  2. ACHTUNG: Auflösungswechsel auf dem Falcon (siehe Ende der Doku)
  3. ***************************************************************
  4. ACHTUNG: TT ohne 'graphic card', siehe Ende der Doku
  5. ****************************************************
  6.  
  7. ****************************************************************************
  8.                  M_PLAYER.PRG-DOKUMENTATION Version 2.30
  9. ****************************************************************************
  10.  
  11.      Quick Time-(MOV) und AVI-Player (mit Sound), SEQ/FLM,PI1+DLT/DL,
  12.               FLI/FLC/FLH und GIF
  13.          sowie Erzeugung von QuickTime-Movies
  14.              und GIF-Movies
  15.  
  16. Autor:
  17. ******
  18. TELLO Guillaume
  19. 240 rue Estienvrin
  20. 49260 Montreuil Bellay (Frankreich)
  21. Email: gtello@planete.net
  22.  
  23. Download M_PLAYER from:
  24.     http://www.tripnet.se/~mille
  25.     http://www.magmacom.com/~nima
  26.  
  27.                 A L L G E M E I N E S
  28.                 *********************
  29.  
  30. Wichtig:
  31.  
  32. ******  D I E S E S   P R O G R A M M   I S T   S H A R E W A R E ! *******
  33.  
  34. Um sich registrieren zu lassen, schickt man US$ 10 (50-60 FF, £7, DM 15)
  35. an den Autor (Adresse siehe oben) oder per Bankverbindung an:
  36.  
  37. Crédit Agricole Anjou Mayenne / 49 Angers, n° compte: 10434852000
  38.  
  39. (Anm.: Die Gebühren deutscher Banken für Auslandsüberweisungen sind
  40. unverschämt hoch (wie sagte noch Bert Brecht??). Besser (und billiger) ist es,
  41. Guillaume einen Euroscheck per Schneckenpost zu schicken).)
  42.  
  43. Nach kurzer Zeit, erhält man eine personalisierte Version.
  44. Da Upgrades und die Schlüssel per email verteilt werden, sollte man bei
  45. seinem Registrierungsantrag neben der postalischen auch seine email-
  46. Adresse angeben.
  47.  
  48.  
  49. Was das Programm kann:
  50. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  51.     ...kann QuickTime-Movies aus einer Serie von Bilder (und optional einem
  52.     Soundfile) erzeugen.
  53.     Unterstützte Bildformate:
  54.         - TGA2 (für RLE16-Kompressionsmethode)
  55.         - IMG ('ximg', 256 Farben) (für RLE8-Kompressionsmethode)
  56.     SoundFormate:
  57.         - AVI, 8/16 bits, mono/stereo
  58.         - WAV, 8/16 bits, mono/stereo
  59.     (siehe auch BATCH und SLIDSHOW.DOC)
  60.  
  61.     ...kann GIF-Animated-Movies aus einer Serie von GIF-Bilder
  62.     erzeugen (87a oder 89a):
  63.              - M_PLAYER extension with number of frames
  64.         - DELAY extension with the timing infos
  65.         - NETSCAPE extension with the looping infos
  66.     (siehe auch BATCH und SLIDSHOW.DOC)
  67.  
  68.     ...spielt 10 Typen von Animationsfiles:
  69.         - *.MOV (Quick Time)
  70.                 - Bildkompressionsmethoden:
  71.                     CVID (komprimiertes yuv)
  72.                     RLE1, RLE2 (grey or col), RLE4 (grey or col),
  73.                     RLE8 (grey or col), RLE16, RLE24, RLE32
  74.                     SMC8 (grey or col)
  75.                     RAW1, RAW2 (grey or col), RAW4 (grey or col),
  76.                     RAW8 (grey or col), RAW16, RAW24, RAW32
  77.                     RPZA (15 bits)
  78.                     YUV2, YUV9, YVU9 (unkomprimiertes yuv)
  79.                 - Sound: mono/stereo, 8/16 bits in TWOS- oder RAW-Format
  80.                 - Schalter für Tonwiedergabe
  81.                      - Schalter für Bild/Ton-Synchronisation
  82.         - *.AVI (Video for Windows)
  83.                 - Bildkompressionsmethoden:
  84.                     CVID
  85.                     CRAM8, CRAM16
  86.                     MSVC8, MSVC16
  87.                     RLE8
  88.                     RGB8
  89.                     YUV9, YVU9
  90.                 - Sound mono/stereo, 8/16 bits in TWOS- oder RAW-Format
  91.                 - Schalter für Tonwiedergabe
  92.                      - Schalter für Bild/Ton-Synchronisation
  93.         - *.FLI/FLC/FLH    (Autodesk Animator)
  94.         - *.SEQ        (Cyber Paint)
  95.         - *.PI1 + *.DLT    (Cyber)
  96.     - *.FLM        (Kinetic Microsystems)
  97.     - *.FLM        (Lexicor)
  98.     - *.DL        (???)
  99.                 - nur Grafik
  100.                 - 'max speed' oder 'normal speed'
  101.                 - 'loop mode' (Shift-Taste)
  102.                 (PI1 and DLT must have the same name and be located into
  103.                 the same directory, select the PI1 file to see the anim)
  104.  
  105.         - *.GIF        (Compuserve, 87a und 89a)
  106.             - sychro with the delays (version 89a)
  107.             - number of frames displayed in the stats dialog only
  108.  
  109.     ... "step by step"-Modus (nicht für den NOVA oder TT 256-Farben-Modus)
  110.         - Darstellung jedes Frames (automatisch oder nicht)
  111.         - Frames können als TGA-File gespeichert werden (auto oder nicht)
  112.  
  113.     ... *.BAT (Batch-Files für Slideshows):
  114.         - einfache Befehle zum Laden und Darstellen einer Serie von Bildern
  115.         - Bildformate:
  116.             - TGA2 unkomprimiert (z.B. mit POV erstellt)
  117.             - IMG ('XIMG' und 256 Farben)
  118.             - GIF (87a oder 89a, 256 Farben maxi)
  119.             (in Zukunft werden weitere Formate unterstützt werden, s. SLIDSHOW.DOC)
  120.  
  121.  
  122. Benötigte Hardware:
  123. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  124.    - Atari TT030:
  125.        - Graphic cards:
  126.            - NOVA (256 oder 32768 Farbmodus)
  127.            - Crazy Dots1/2 (256 oder 32768 Farbmodus)
  128.            - Matrix (256 Farbmodus)
  129.            - Cyrel (256 Farbmodus)
  130.     - TT ohne 'Graphic card'
  131.    - Falcon im High-Color-Modus (32768 Farben) und jede Menge RAM (oder
  132.      Outside! Afterburner 040, Blow up, ScreenBlaster, Centurbo I)
  133.    - PowerBook + MagicMac (256 Farbmodus, no sound...)
  134.    - HADES 060 (no sound...)
  135.  
  136.  
  137. Warum braucht man 'jede Menge RAM'?
  138. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  139. Viel Speicher ist nur notwendig, wenn der Sound wiedergegeben werden soll.
  140. 2 MB sollten reichen, um jedes MOV- oder AVI-File ohne gleichzeitige
  141. Tonwiedergabe abspielen zu können, da die Bilder nacheinander direkt von
  142. Disk gelesen und sofort dargestellt werden.
  143.     Die einzige Möglichkeit, die Grafik korrekt (d.h. schnell genug und
  144. synchron zum Sound) wiederzugegeben, ist, den Ton zuerst separat und
  145. komplett in den Speicher zu laden und später beim Laden der Frames
  146. parallel per DMA-Sound wiederzugeben. Auf diese Weise ist die
  147. Tonwiedergabe immer vollständig.
  148.     Allgemein kann man sagen, da₧ der Sound etwa 10% der gesamten Filegrö₧e
  149. einnimmt (ein grober Mittelwert, aber ausreichend für die folgenden
  150. Rechnungen). Jedes MB entspricht 1'23" Sound (bei 12,5 kHz), d.h. auf
  151. einem Falcon mit 2 MB Speicher für den Sound können Animationen von ca.
  152. 2'46" Länge (oder ca. 20 MB Grö₧e) abgespielt werden. Stehen sogar 12 MB
  153. für das Einlesen des Sounds zur Verfügung, so steigt die Gesamtlänge der
  154. abspielbaren Filme auf 16'36" Länge oder ca. 120 MB Grö₧e.
  155.  
  156.  
  157. So ein Mist, ich habe 16 MB TT-RAM, bekomme aber trotzdem keinen DMA-Sound
  158. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  159.     Naja, man sollte die 'Programm im TT-Ram' und 'Malloc im TT-RAM'-Flags des Programms
  160. setzen, um den grö₧tmöglichen Block von ST-RAM freizumachen. In diesem Falle wird
  161. au₧erdem das TT-RAM benutzt, um den restlichen Sound zu laden, der nicht in den
  162. ST-RAM pa₧t. Während der Wiedergabe werden dann die Daten vom TT-RAM blockweise ins
  163. ST-RAM geladen. Um 1.5 MB zu kopieren, werden etwa 0.5 s benötigt, d.h. eventuell kommt
  164. es auch zu kleinen Ausfällen bei der Tonwiedergabe.
  165.  
  166.  
  167.  
  168.            B E D I E N U N G   D E S    P R O G R A M M S
  169.             **********************************************
  170.  
  171.  
  172. Die Files:
  173. ╣╣╣╣╣╣╣╣╣╣
  174.         M_PLAYER.PRG        ; das Program
  175.         M_PLAYER.RSC        ; das Resource-File (mu₧ sich im selben
  176.                        Ordner wie das Programm befinden!)
  177.         MPLYR_EN.DOC        ; englische Dokumentation (Merci Dave Brook!)
  178.         MPLYR_GE.DOC        ; deutsche Dokumentation (Thanks Martin!)
  179.         MPLYR_FR.DOC        ; doc francaise
  180.         MPLYR_SV.DOC        ; svensk DOC
  181.         MP_ICONS.RSC        ; 4 Ikons von Julien Chauveau.
  182.         SLIDSHOW.DOC        ; batch files, MOV-Maker
  183.         HISTORIC.TXT        ; the history
  184.         COMMANDS.DOC        ; the options of the command line (TTP mode)
  185.  
  186. Starten:
  187. ╣╣╣╣╣╣╣╣
  188.     Beim Start durch Doppelklick vom Desktop aus, kann man direkt per Fileselektor ein
  189. Animation wählen. Mann kann auch ein Animationsfile per drag-and-drop auf das Programmikon
  190. ziehen, der Filename kann auch nur aus einer Maske (z.B. *.MOV) bestehen.
  191.  
  192.     Die erste Dialogbox:
  193.  
  194.     1) in der ersten Zeile steht der Typ des geladenen Files
  195.     2) in der grünen Box finden sich Informationen übder die Zahl der Frames und
  196.         die Art der Kompression sowie eine Angabe, ob die Kompressionsmethode vom
  197.         Programm unterstützt ist oder nicht. Falls nicht, so kann immer noch
  198.        die Tonspur aus der Animation wiedergegeben werden (wenn hierfür das
  199.        Format unterstützt ist). Wenn keine Bilddaten vorhanden sind, d.h. wenn
  200.        das File nur Sound enthält, erscheint die Meldung 'No graphics found'.
  201.     3) in der orangen Box stehen Informations über die Sounddaten, d.h.
  202.        Frequenz, Auflösung, Geschwindigkeit. Einige Frequenzen und Auflösungen
  203.        (4 bits) werden nicht unterstützt. Manchmal wird trotz der Meldung
  204.        "Supported" kein Sound gespielt, in diesem Falle ist dem System der
  205.        Speicher ausgegangen. Falls die Datei nur Bilddaten enthält, erscheint
  206.        die Meldung 'No sound'; in diesem Fall können aber trotzdem die
  207.        Grafikdaten abspielt werden, wenn deren Kompressions-Methode unterstützt
  208.        wird.
  209.    4) 'Play sound' schaltet die Soundwiedergabe ein (natürlich nur, wenn
  210.       auch tatsächlich Sounddaten verhanden sind).
  211.     5) 'Synchronize' schaltet die Synchronisation zwischen Bild und Ton ein
  212.        (wenn sowohl Grafik- als auch Sounddaten vorhanden sind). Ist diese
  213.        Option ausgeschaltet, werden die Bilder in der im File angegeben Frame-
  214.        Rate wiedergegeben (also schneller oder langsamer als der parallel
  215.        ablaufende Sound).
  216.    6) 'Max speed' spielt FLx/SEQ-Animationen mit maximaler Geschwindigkeit,
  217.        d.h. ohne zusätzliche Pause zwischen einzelnen Frames ab. Ist diese
  218.        Option nicht gesetzt, werden die ANimationen in ihrer normalen
  219.        Geschwindigkeit abgespielt).
  220.    7) Weitere Informationen über das Programm und dessen Autor finden sich
  221.       unter 'Information...' :) . Bitte denkt daran, da₧ das Programm
  222.       Shareware ist! Jede Registrierung für den sehr moderaten
  223.       Registrierungsbetrag wird die Weiterentwicklung des Programms
  224.       unterstützen!
  225.     8) 'Go!' startet die Animation. Während der Sound geladen wird,
  226.        erscheint eine Dialogbox mit der Meldung "Loading sound...".
  227.        Wenn "(Alt) Go!" angezeigt wird, kann der Step-by-Step-Modus benutzt
  228.        werden (s.u.) Bei einerm  BATCH-File schaltet die 'Alt'-Taste zwischen
  229.        "slide-show" und "create-mov-file" um.
  230.     9) Mit 'Cancel' kehrt man ohne Wiedergabe des aktuellen Files zum
  231.        Fileselektor zurück.
  232.  
  233. Statistik:
  234. ╣╣╣╣╣╣╣╣╣╣
  235.     Nach Ende der Animation, erscheint eine Dialogbox mit einigen statistischen
  236. Angaben (falls das File keine Bild- sondern nur Tondaten enthielt, erscheint
  237. diese Box natürlich nicht).
  238.     * "Total frames:" die Gesamtzahl der Frames im File
  239.     * "Frames displayed:" die Zahl der Frames, die während der Wiedergabe dargestellt
  240.        wurden. Dieser Wert kann bei gewählter Bild/Ton-Synchronisation manchmal unter
  241.        100% liegen, weil einige Frames übersprungen werden mu₧ten.
  242.    * "Total time:" die Gesamtlänge in Sekunden.
  243.     * "Average:" Zahl der abgespielten Frames/Sekunde
  244.  
  245. Beenden des Programms:
  246. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  247. Wurde das Programm direkt vom Desktop gestartet, kehrt man nach Ende jeder
  248. Animation wieder zum Filselektor zurück. Zum Beenden des Programms mu₧ man in
  249. diesem Falle "Abbruch" im Fileselektor wählen.
  250.  
  251. Wie stoppt man die Wiedergabe?
  252. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  253.     ...mit der 'Control'-Taste (no stats box).
  254.     With SHIFT and an animation that loops (GIF for example), the
  255. display is stopped at the end of the current loop and you get the stats
  256. box.
  257.  
  258. "Step-by-Step"-Modus
  259. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  260. 1) Fileselector:
  261.     Zunächst mu₧ der Pfad, in dem die TGA-Files später abgespeichert werden
  262.     sollen, angegeben werden. Der vorgegebene Dateiname ist:
  263.         FRM00001.TGA (bis FRM99999.TGA, also 99999 verschiedene Files)
  264.     Die ersten drei Buchstaben können auch im Fileselecktor geändert werden, um
  265.     die Vorgabe "FRM" zu ersetzen.
  266.  
  267. 2) Mini-Menü:
  268.     (S) save: speichert den aktuellen Frame
  269.     (A) all : speichert alle Frames beginnend mit dem gerade dargestellten.
  270.                   Dieser Vorgang kann mit der CONTROL-Taste auch wieder
  271.                   unterbrochen werden. Ein Signalton während der Speicherns weist
  272.                   auf einen Schreibfehler hin (beispielsweise, weil die Platte voll
  273.                   ist).
  274.     (Q) quit: bricht den Modus ab.
  275.     Esc      : dito
  276.     (R) run : zeigt alle Frames automatisch an (bis man die CONTROL-
  277.                  Taste drückt).
  278.     (alle anderen Tasten schalten die Wiedergabe ein Frame weiter)
  279.  
  280. 3) Über die TGA-Files:
  281.     Format: TGA 2 unkomprimiert, der Header ist 18 Bytes lang:
  282.  
  283.         Long $00000200
  284.         Long $00000000
  285.         Long $00000000
  286.         Word Bildbreite    (Intel)
  287.         Word Bildhöhe    (idem)
  288.         Word $1820
  289.         Dann folgen die Pixel der Bildzeilen mit 3 Bytes pro Pixel: blau/grün/rot
  290.  
  291.  
  292.        E I N I G E   F R A G E N
  293.     *************************
  294.  
  295. Wie ist das Programm entstanden?
  296. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  297. Das Programm wurden komplett in Assembler 68030 unter ASSEMBLE von Brainstorm
  298. geschrieben.
  299.  
  300.  
  301. Frequenzen
  302. ╣╣╣╣╣╣╣╣╣╣
  303. MAC- oder PC-Files verwenden üblicherweise die Frequenzen 11025 Hz, 22050 Hz
  304. oder 44100 Hz (toleriet wird aber auch eine Abweichung von 2%). Wenn M_PLAYER
  305. die Sounddaten lädt, führt es eine Umrechnung auf die Frequenzen 12,5kHz, 25kHz
  306. oder 50kHz (die DMA-Frequenzen) durch, indem aus jedem 8 Byte langen Block das
  307. letzte Byte wiederholt wird.
  308.  
  309. Bugs?
  310. ╣╣╣╣╣
  311. Das kann man nie ausschlie₧en, hängt aber meist weniger mit M_PLAYER
  312. zusammen als vielmehr mit anderen parallel laufenden oder TSR-
  313. Programmen). In folgenden Fällen können Probleme auftreten:
  314.    ... Metados Ok (version 2.70)
  315.    ... Wenn die Animation grö₧er als die aktuelle Bildschirmauflösung ist.
  316.        Ausweg: Start des Programms unter einer virtuellen Auflösung.
  317.        ... Eventuelle Probleme bei der Soundwiederaufgabe auf dem Falcon können mit
  318.         FPATCH2.PRG behoben werden.
  319. Die Probleme in Zusammenhang mit Turbo Veille und Extendos (thanks Yu-Ou Wang)
  320. sind seit Version 1.36 behoben.
  321. Die Probleme mit FREEDOM sind seit Version 2.05 behoben.
  322.  
  323. Vielen Dank für Tests und Bugreports an:
  324.     - Pascal Ricard de Pierrevert    (Falcon 4Mo)
  325.     - Julien Chauveau de Méron    (Falcon 4Mo)
  326.     - Hervé Piedvache. de Paris    (Falcon 4Mo)
  327.     - Dave Brook Stony Stratford/GB    (TT 20Mo + Crazy Dots2)
  328.     - Magnus Kollberg de Suède    (Falcon 4Mo)
  329.     - Martin Rothaemel d'Allemagne    (TT 8Mo + NOVA)
  330.     - Yu-Ou Wang de Paris        (Falcon 40MHz)
  331.     - Oliver Skelton de G.Bretagne    (Falcon + BlowUp Hard 1)
  332.     - Jacobo Morro d'Espagne    (Falcon)
  333.     - Rémi Vanel de France        (Falcon)
  334.  
  335. Wichtig:
  336.  
  337. ******  D I E S E S   P R O G R A M M   I S T   S H A R E W A R E ! *******
  338.  
  339. Ab Version 1.4 ist M_PLAYER Shareware! Nicht-registrierte Versions sind
  340. dann auf monochrome Darstellung beschränkt. Um die volle
  341. Leistungsfähigkeit von M_PLAYER im 32768-Farbmodus zu erleben, la₧t euch
  342. registrieren; ihr werdet beeindruckt sein.
  343. Sie haben gesagt, man könnte das nicht schaffen (auf einem Atari)!
  344.  
  345.  
  346.     If you want to register and get the color copy, just send me 7UKP,
  347. or the equivalent. I'll send you your personal version (post or email).
  348.  
  349.     (7UKP = US$10 = CAN$15 = 15DM = 50/60F)
  350.  
  351. Nach kurzer Zeit, bekommt man den Registrierungsschlüssel zugesandt. Es
  352. steht ausser Frage, da₧ das die beste Investition von £7 für ein
  353. Shareware-Programm ist, die man sich vorstellen kann :) . Ausserdem
  354. trägt man so zu einer stetigen Weiterentwicklung dieses gro₧artigen
  355. Programms bei. Registrierte Anwender bekommen auch regelmä₧ig (und
  356. kostenlos) die neuestenroutine Upgrades zugeschickt. Da - wenn möglich -
  357. die Upgrades und die Schlüssel per email verteilt werden, sollte man bei
  358. seinem Registrierungsantrag neben der postalischen auch seine email-
  359. Adresse angeben.
  360.  
  361.  
  362. ********************************
  363. Auflösungswechsel auf dem Falcon
  364. ********************************
  365. Die Programme schalten für die Wiedergabe einer Animation in den True Color-
  366. Modus um (falls sie nicht in diesem gestartet wurden). Ich kann aber keinerlei
  367. Garantie für die Sicherheit meiner Routine geben! Der Einsatz erfolgt auf
  368. eigene Gefahr! Für eventuelle Schäden am Monitor etc. werde ich deshalb
  369. nicht aufkommen! Die Routinen wurden erfolgreich 16- und 256-Farbmodus
  370. gestetet, sie funktionierten aber nicht vom monochromen oder vom 4-Farbmodus
  371. aus!
  372.     Die einfachste Möglichkeit, den Auslösungswechsel zu vermeiden, ist,
  373. M_PLAYER bereits im True-Color-Modus vom Desktop aus zu starten.
  374.     Falls der Monitor ein seltsames Geräusch ('clunk') bei jedem
  375. Auflösungswechsel macht, sollte man sehr vorsichtig sein!
  376.  
  377. ***********************
  378. TT without graphic card
  379. ***********************
  380.  
  381.     The displays switches to 320x480x256 to play the animations. If
  382. the height allows it, the animation is doubled to correct the aspect
  383. ratio, if the width is greater than 320 pixels, the image is reduced to
  384. its half: finaly, every animation up to 640x480 is accepted.
  385.     Limits are those of the NOVA 256 colors mode:
  386.     - 16bits or TC animations are replayed in grey
  387.     - other animations are replayed in colors (<=256)
  388.     - no step by step mode
  389.  
  390.     The display is slower than with a graphic card, because instead of
  391. writting directly into the video RAM, the program uses a buffer witch is
  392. re-encoded bit by bit into the video RAM.
  393.     For some specific animations (SEQ, DLT, FLM, DL) a routine adapted
  394. to the TT has been included, so you'll get a very good speed with those
  395. anims.
  396.